<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>ManagerManager for Modx: Installation</title>
<link href="css/mm.css" rel="stylesheet" type="text/css" />

</style>
</head>

<body>

<div id="banner">

</div>


<div id="main">
    <div id="nav">
        <ul>
            <li><a href="index.htm">Introduction</a></li>
            <li>Installation</li>
            <li><a href="getting-started.htm">Getting started</a></li>
            <li><a href="field-names.htm">Field names</a></li>
            <li><a href="fields.htm">Fields</a></li>
            <li><a href="tabs.htm">Tabs</a></li>
            <li><a href="widgets.htm">Widgets</a></li>
            <li><a href="sections.htm">Sections</a></li>
            <li><a href="changelog.htm">Changelog</a></li>
        </ul>   
    </div>
    
  <div id="content">
    <h1>Installation</h1>
    <h2>Compatibility</h2>
    <p>If you are running ModX 0.9.6.x, this version will not work. You should download previous version 0.3.2 of ManagerManager. </p>
    <p>This version is designed for ModX 1.0.0</p>
    <h2>New install</h2>
    <ol>
      <li>Unzip the downloaded file</li>
      <li>In ModX manager, create a new plugin called &quot;ManagerManager&quot; and paste in the code from <strong>plugin.txt</strong></li>
      <li> In the &quot;System Events&quot; tab, check the following checkboxes:</li>
    </ol>
    <ul>
      <li><strong>OnDocFormRender</strong></li>
      <li><strong>OnDocFormPrerender</strong></li>
      <li><strong>OnPluginFormRender</strong></li>
      <li><strong>OnTVFormRender</strong></li>
    </ul>
    <ol>
  <li value="4">On the configuration tab, paste the following code into the &quot;Plugin configuration&quot; box, and click &quot;Update parameter display&quot;:<br />
  	<code>&amp;config_chunk=Configuration Chunk;text; &amp;remove_deprecated_tv_types_pref=Remove deprecated TV types;list;yes,no;yes &amp;which_jquery=jQuery source;list;local (assets/js),remote (google code),manual url (specify below);remote (google code) &amp;js_src_type=jQuery URL override;text; </code> </li>
  <li>Copy all the files from the zip file  into <strong>/assets/plugins/managermanager </strong>and upload.<br />
  	</li>
  <li>If you would like to edit your rules through the <strong>Manager</strong> interface, create a chunk called 'mm_rules' (if you want to call it something different, you can edit this in the code pasted from plugin.txt). You can then put your rules in there.<br />
    OR if you would like to edit your rules via a <strong>file</strong>, add your rules to the mm_rules.inc.php file in the /plugins/managermanager. Note - if you have a chunk defined and has some content in it, this will override the file contents.</li>
    </ol>
    <p>Note:  It is suggested that you disable the ShowImageTVs plugin, and use the mm_widget_showimagetvs widget instead, e.g. add this line to your rules:</p>
    <code>mm_widget_showimagetvs();</code>
    <h2>Upgrade</h2>
    <h3>From 0.3.x:</h3>
	<ol>
		<li>Replace <strong>all</strong> files in the /plugins/managermanager directory and subdirectories</li>
		<li>Replace your existing plugin code with the new version from plugin.txt. You may need to reset some of your configuration options in the &quot;Configuration&quot; tab of the plugin.</li>
		<li>Some tabs/sections have new/changed names due to differences in the manager. Please see the <a href="changelog.htm">changelog</a> for details.</li>
		<li>Tick the <strong>OnTVFormRender</strong> event.</li>
	</ol>
<h3>From &lt; 0.3:</h3>
    <ol>
      <li>Replace <strong>all</strong> files in the /plugins/managermanager directory and subdirectories</li>
      <li>Copy the rules you've added to your existing plugin, and paste them either to a chunk called &quot;mm_rules&quot; <strong>or</strong> to the &quot;mm_rules.inc.php&quot; file.</li>
      <li>Replace your existing plugin code with the new version from plugin.txt</li>
    </ol>
    <h3>From &lt;= 0.2.2:</h3>
    <p>All the above PLUS: If you have used <strong>mm_hideField</strong> or <strong>mm_hideTab</strong> functions you will need to rename them to <strong>mm_hideFields</strong> and <strong>mm_hideTabs</strong></p>
    <h2>Configuration</h2>
    <p>All configuration options are set through the &quot;Configuration tab&quot; of the plugin.</p>
    <h3>Configuration chunk</h3>
    <p>The name of the chunk which contains MM rules (optional, if you put your rules in the external file mm_rules.inc.php)</p>
    <h3>Remove deprecated TV types</h3>
    <p>If selected YES, deprecated TV types will not be shown on the TV creation / editing screen.</p>
    <h3>jQuery source    </h3>
    <p>ManagerManager uses jQuery (currently version 1.3.2) to carry out the modifications to the Manager pages. You can choose where the jQuery library is located:</p>
    <p><strong>local</strong> - use the version of jQuery which is included with the ModX 1.0.0 distribution<br />
    	<strong>remote</strong> - use the Google Code hosted version of jQuery<br />
    	<strong>manual url</strong> - enter your own URL for the location of the jQuery library </p>
  </div>
</div>
</body>
</html>
